Function Reference

_AD_GroupRemoveManager

Remove the group manager from a group or only remove the manager's modify permission.

#Include <AD.au3>
_AD_GroupRemoveManager($sGroup[, $bFlag = False])

 

Parameters

$sGroup Groupname (sAMAccountName or FQDN)
$bFlag Optional: if True the function only removes the manager's modify permission

 

Return Value

Success: 1
Failure: 0, @error set
    1 - $sGroup does not exist
    2 - $sGroup does not have a manager assigned

 

Remarks

None.

 

Related

_AD_SetGroupManagerCanModify, _AD_GroupManagerCanModify, _AD_GroupAssignManager

 

Example


#AutoIt3Wrapper_AU3Check_Parameters= -d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6
#AutoIt3Wrapper_AU3Check_Stop_OnWarning=Y
; *****************************************************************************
; Example 1
; Removes the group manager (attribute "managedby") from a group.
; *****************************************************************************
#include <AD.au3>
#include <ButtonConstants.au3>
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>

; Open Connection to the Active Directory
_AD_Open()
If @error Then Exit MsgBox(16, "Active Directory Example Skript", "Function _AD_Open encountered a problem. @error = " & @error & ", @extended = " & @extended)

Global $iReply = MsgBox(308, "Active Directory Functions - Example 1", "This script removes the group manager from a group." & @CRLF & @CRLF & _
        "Are you sure you want to change the Active Directory?")
If $iReply <> 6 Then Exit

; Enter group to remove the manager from
#region ### START Koda GUI section ### Form=
Global $Form1 = GUICreate("Active Directory Functions - Example 1", 714, 124)
GUICtrlCreateLabel("Group (samAccountName or FQDN):", 8, 10, 231, 17)
Global $IGroup = GUICtrlCreateInput("", 241, 8, 459, 21)
Global $BOK = GUICtrlCreateButton("Remove Manager", 8, 82, 121, 33)
Global $BCancel = GUICtrlCreateButton("Cancel", 628, 82, 73, 33, BitOR($GUI_SS_DEFAULT_BUTTON, $BS_DEFPUSHBUTTON))
GUISetState(@SW_SHOW)
#endregion ### END Koda GUI section ###

While 1
    Global $nMsg = GUIGetMsg()
    Switch $nMsg
        Case $GUI_EVENT_CLOSE, $BCancel
            Exit
        Case $BOK
            Global $sGroup = GUICtrlRead($IGroup)
            ExitLoop
    EndSwitch
WEnd

; Remove group manager
Global $iValue = _AD_GroupRemoveManager($sGroup)
If $iValue = 1 Then
    MsgBox(64, "Active Directory Functions - Example 1", "Successfuly removed the group manager from '" & $sGroup & "'")
ElseIf @error = 1 Then
    MsgBox(64, "Active Directory Functions - Example 1", "Group '" & $sGroup & "' does not exist")
ElseIf @error = 2 Then
    MsgBox(64, "Active Directory Functions - Example 1", "Group '" & $sGroup & "' does not have an assigned manager to remove")
Else
    MsgBox(64, "Active Directory Functions - Example 1", "Return code '" & @error & "' from Active Directory")
EndIf

; Close Connection to the Active Directory
_AD_Close()